Creating a Process Monitoring Object

This topic describes the procedure to create a Process Monitoring Object.

A Process Monitoring Object is the fundamental building block for analyzing the health of the Business Processes. It is the key interface on which the process analysis and monitoring takes places at the appropriate time for aggregated process or activity instances. The Process Monitoring Object comprises the Business Attributes taken from a Process and the Attributes of an external web service.

1. Select a starting point and select (Process Monitoring Object) to create a Process Monitoring Object. The Untitled Process Monitoring Object - Process Monitoring Object window appears.
2. Enter Name and Description of the Process Monitoring Object.
3. Select Process as first step in creating a Process Monitoring Object.
   Note:
4. If you select the business process as a runtime reference, then you cannot edit or delete the message filter. If the business process does not have message filter, then you can create Process Monitoring Object on Standard attributes only.
5. In a Business Process, for any input xml element, specify 'date' parameter value in YYYY-MM-DDThh:mm:ss:S format.
6. Select the required activity events under Events section and click Next to view Select Attributes page.
7. Select the Process or Activity attributes, check Include Contextual Information option and click Next to choose a Web service to get the Contextual information.

   Note:

   • By default, the Process Attributes also get listed on the Select Attributes page.
   • Getting the Contextual Information is only an optional step.
   • The mappings to the database columns for the selected attributes are generated only if there is a Service Container for BAM with the attached Method Set BAM Monitor Web Service Interface. If the column maps are not generated for the attributes of a Process Monitoring Object, when this Process Monitoring Object is packaged and deployed on another machine, the generated column maps for the deployed Process Monitoring Object may not be same as original Process Monitoring Object attribute column maps.
   • For building a Process Monitoring Object, user has the option to select the process or context attributes of each data type with the below specified limits:
     
     • String - 15
     • Numeric - 10
     • Decimal - 10
     • Date - 10
   • If the Service Container for BAM is up and running, then the above specified data type limits are validated. There may be a business need, where you have to add more columns in a Process Monitoring Object. In those scenarios, add the necessary columns by altering the table, BAM_OBJECTS_DATA. Follow the column names pattern strictly as mentioned in<Process Platform install directory>\components\bam\database\createscripts\BAM_<DBVendor>_DATA.sql. Perform this task only when you have to add extra columns. For MYSQL Database, you have to append the connection string withzeroDateTimeBehavior=convertToNull, if the columns added to BAM Repository for datetime datatype are specified with default value.
   • Refer guidelines to develop Process Monitoring Object for more information on guidelines for developing a Process Monitoring Object.
8. Fill the required information in the relevant columns on the Contextual Information page, and click Next to view Summary of the Selected Attributes.
9. Click Finish on the Summary page to complete the creation process of Process Monitoring Object.
   The Process Monitoring Object is created and added to the project content tree.

   Note: You cannot rename a Process Monitoring Object after it is created.

   After you complete this task:
   You must publish the Process Monitoring Object to the organization.